home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 039a / pdm_106.zip / PDM_106.DOC < prev    next >
Text File  |  1991-06-08  |  7KB  |  198 lines
  1. ┌────────────────────────────────────────────────────────────────────────┐
  2. │                  PDM * Pull-Down Menu * Development System             │
  3. ├────────────────────────────────────────────────────────────────────────┤
  4. │                              PDM Documentation                         │
  5. │                      (c) 1990-1991 ClipCode Associates                 │
  6. └────────────────────────────────────────────────────────────────────────┘
  7.  
  8. PDM is a Pull-Down menu development tool for Clipper(R), compliant with
  9. the IBM(tm) SAA/CUA(tm) standards.
  10.  
  11. PDM version 1.06 requires the CC.LIB function library for Clipper,
  12. at least version 1.04.
  13.  
  14. PDM DOCUMENTATION OVERVIEW:
  15.  1. Quick Start
  16.  2. PDM Development System - Goals
  17.  3. Packing List
  18.  4. Menu Definition Files
  19.  5. PDM Functions
  20.  6. CC.LIB Functions
  21.  7. CC.LIB Documentation & Norton Guide Help Text
  22.  8. PDM Debug mode
  23.  9. PDM Generated source code
  24. 10. Registering PDM
  25.  
  26.  1. QUICK START:
  27.     ════════════
  28.  
  29.     1) Run the PDM_MAKE.BAT file to link the PDM.OBJ file into PDM.EXE.
  30.        (check the CLIPPER library paths in the PDM_MAKE.BAT file)
  31.     2) Run the PDM.EXE program and select a .PDM menu definition file to
  32.        work with.
  33.     3) Examine the fully commented .PDM menu definition files.
  34.     4) Compile, link, and run the generated .PRG source code files.
  35.     5) Register your copies of PDM Dev Sys & CC.LIB!
  36.        (see the PDM_106.LIC file)
  37.  
  38.  
  39.  2. PDM Development System - Goals:
  40.     ═══════════════════════════════
  41.  
  42.     1) Provide a pull-down menu system for Clipper programs.
  43.  
  44.     2) Create a powerful, quick, & easy-to-use menu development system
  45.        for Clipper programmers.
  46.  
  47.        a. externally defined menu definitions:
  48.           Use a brief, simple externally defined menu definition for
  49.           development (to avoid recompiling every menu change).
  50.  
  51.        b. quick prototyping:
  52.           The system should allow creating a working model in an hour.
  53.  
  54.        c. generated source code:
  55.           The PDM system should be able to generate the necessary source
  56.           code to identically reproduce the functionality of the PDM
  57.           Development System.
  58.           The final system should be able to continue to use externally
  59.           defined menu definition files or the generated source code.
  60.          
  61.     3) The resulting pull-down menu should be able to be IBM(tm) SAA/CUA
  62.        compliant.
  63.  
  64.  
  65.  3. PACKING LIST (18 files):
  66.     ════════════════════════
  67.     PDM.OBJ          the main PDM program
  68.     PDM_MAKE.BAT     batch file to link PDM.OBJ and create PDM.EXE
  69.  
  70.     PDM_106.DOC      PDM documentation
  71.     PDM_106.LIC      PDM license & registration info
  72.  
  73.     CAP.PDM          PDM Menu definition sample files ( with FUNC/PROC )
  74.     PLP.PDM          "
  75.     QC20.PDM         PDM Menu definition sample files ( without FUNC?PROC )
  76.     PDMDEMO1.PDM     "
  77.     PDMDEMO2.PDM     "
  78.     PW20.PDM         "
  79.     WP51.PDM         "
  80.  
  81.     CAP.PDM          PDM generated programs from the above files ( with FUNC )
  82.     PLP.PDM          "
  83.     QC20.PRG         PDM generated programs from the above files (without FUNC)
  84.     PDMDEMO1.PRG     "
  85.     PDMDEMO2.PRG     "
  86.     PW20.PRG         "
  87.     WP51.PRG         "
  88.  
  89.  
  90.  4. MENU DEFINITION FILES:
  91.     ══════════════════════
  92.     Menu definition files are ASCII text files that define your menu.
  93.     See files: *.PDM  for clearly documented examples.
  94.  
  95.     KEYWORDS      MEANING
  96.     ────────      ─────────────────────────────────────────────────────
  97.     *             Comment line
  98.     &&            Comment the rest of line
  99.     #             prefix to a KEYWORD
  100.     ""            use double quotes only to identify strings
  101.     -             a unselectable horiz separator bar
  102.     @             level break of vertical menu element
  103.  
  104.     #DIMARR       dim# elements: top menu,total vert elements
  105.                     (count line dividers as elements)
  106.     #HORIZMENU    trigger letter, letter position in text string,
  107.                     hot key, menu option text
  108.     #MENUCOL      column of 1st top menu option
  109.                     (all others columns are optional: 1,12,15,...)
  110.     #VERTMENU     trigger letter, letter position in text string,
  111.                     selectable, menu option text
  112.     #HELPTEXT     80 character length message text for message line
  113.     #COLORS       PDM color strings for SET COLOR TO
  114.  
  115.  
  116.  5. PDM Functions:
  117.     ══════════════
  118.     See CC.LIB 1.04 Norton Guide for the following PDM functions:
  119.  
  120.     MENUPD()     Pull-Down Menu with highlighted trigger letters
  121.     PDM_FSETUP() Read PDM_INIT() (Pull Down Menu) set up values from
  122.                  an ASC file
  123.     PDM_INIT()   Initialize remaining optional PDM PUBLIC arrays
  124.     PDM_HELP()   Default Help Message Box, if no PDM Help Function
  125.                  is defined
  126.     MENUPDV()    Vertical menu function (internal to MENUPD() )
  127.     PDM_SETUP()  this function is generated by PDM.EXE & *.PDM definition
  128.                  file it replaces PDM_FSETUP() in a finished debugged program
  129.  
  130.  
  131.  6. CC.LIB Functions:
  132.     ═════════════════
  133.     The PDM functions listed above above are included in CC.LIB 1.04 or greater.
  134.     In addition CC.LIB has 115+ additional functions to speed your program
  135.     development time and enhance your programs.
  136.  
  137.  
  138.  7. CC.LIB Documentation & Norton Guide Help Text:
  139.     ══════════════════════════════════════════════
  140.     CC.LIB comes with complete library documentation.  The documentation is
  141.     supplied in three formats:
  142.  
  143.     1) On line: Norton Guide Help Text
  144.     2) CC_104.DOC is a text file containing the same help text
  145.     3) CC_DEMO.PRG provides a working code example of almost every function.
  146.  
  147.  
  148.  8. PDM Debug mode:
  149.     ═══════════════
  150.     PDM.EXE can be put in "Debug mode."  This mode causes the current menu
  151.     definition command and the current array subscript being processed to be
  152.     displayed on the "Loading Menu Definition File" screen.
  153.  
  154.     It is very likely that on the first or second attempt to get your new
  155.     menu definition file (*.PDM) to load correctly you will have an error.
  156.     By being in "Debug mode," you will have displayed on the screen when the
  157.     error occurs, the current command and array subscript.
  158.  
  159.     To enable Debug mode run PDM with the parameter "DEBUG"
  160.  
  161.     example: C> PDM debug <EnterKey>
  162.  
  163.  
  164.  9. PDM Generated source code
  165.     ═════════════════════════
  166.     The source code generated by PDM.EXE and your menu definition (*.PDM) file
  167.     is immediately ready to be compiled, linked, and run.  You must link the
  168.     code with CLIPPER.LIB, CC.LIB, and EXTEND.LIB.
  169.  
  170. 10. Registering PDM
  171.     ═══════════════
  172.     When you register PDM, you will receive a unique Registration Code from
  173.     ClipCode Associates.  This code will be embedded into your copy of PDM.EXE
  174.     along with the name and phone number that you sent to ClipCode Associates
  175.     when you registered.  To apply your Registration Code when you receive it,
  176.     run PDM with the parameter "REGISTER", the answer the input fields.
  177.  
  178.     example: C> PDM register <EnterKey>
  179.  
  180.     Input: Name
  181.            Phone Number
  182.            Registration Code
  183.  
  184.     Your registered copy of PDM.EXE is now fully enabled!
  185.  
  186.  
  187. Thank you for using PDM & CC.LIB,
  188.  
  189.  
  190. Robert Stribling
  191. ClipCode Associates
  192. June 1991
  193.  
  194. (803) 654-5154
  195. CIS account: 73357,1120
  196.  
  197. <eof>
  198.